home *** CD-ROM | disk | FTP | other *** search
<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="de" xml:lang="de"><head><!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> <title>Beenden und Neustarten - Apache HTTP Server</title> <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> <link href="./images/favicon.ico" rel="shortcut icon" /></head> <body id="manual-page"><div id="page-header"> <p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p> <p class="apache">Apache HTTP Server Version 2.0</p> <img alt="" src="./images/feather.gif" /></div> <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div> <div id="path"> <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP-Server</a> > <a href="http://httpd.apache.org/docs-project/">Dokumentation</a> > <a href="./">Version 2.0</a></div><div id="page-content"><div id="preamble"><h1>Beenden und Neustarten</h1> <div class="toplang"> <p><span>Verfⁿgbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> | <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Espa±ol"> es </a> | <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="./ru/stopping.html" hreflang="ru" rel="alternate" title="Russian"> ru </a></p> </div> <p>Dieses Dokument umfasst das Beenden und Neustarten des Apache auf Unix-Σhnlichen Systemen. Anwender von Windows NT, 2000 und XP sollten <a href="platform/windows.html#winsvc">Betreiben des Apache als Dienst</a> lesen, wΣhrend hingegen Anwender von Windows 9x sowie ME <a href="platform/windows.html#wincons">Betreiben des Apache als Konsolenanwendung</a> lesen sollten, um mehr Informationen zur Handhabung des Apache auf diesen Systemen zu erhalten.</p> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Einleitung</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#term">Beenden</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#graceful">Unterbrechungsfreier Neustart</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#hup">Neustarten</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#race">Anhang: Signale und Wettkampfsituationen</a></li> </ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="programs/httpd.html">httpd</a></li><li><a href="programs/apachectl.html">apachectl</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="introduction" id="introduction">Einleitung</a></h2> <p>Um den Apache zu stoppen oder neu zu starten, mⁿssen Sie ein Signal an den laufenden <code>httpd</code>-Prozess senden. Es gibt zwei M÷glichkeiten, diese Signale zu senden. Zum einen k÷nnen Sie den Unix-Befehl <code>kill</code> verwenden, um den Prozessen direkt Signale zu senden. Sie werden feststellen, dass auf Ihrem System mehrere <code>httpd</code>-Programme laufen. Sie sollten jedoch nicht jedem dieser Prozesse ein Signal senden, sondern nur dem Elternprozess, dessen PID im <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> steht. Das hei▀t, Sie sollten es niemals n÷tig haben, einem anderen Prozess, als dem Elternprozess, ein Signal zu senden. Es gibt drei Signale, die Sie an den Elternprozess senden k÷nnen: <code><a href="#term">TERM</a></code>, <code><a href="#hup">HUP</a></code> und <code><a href="#graceful">USR1</a></code>, die nachfolgend beschrieben werden.</p> <p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen Befehl wie z.B.:</p> <div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div> <p>Die zweite Methode, dem <code>httpd</code>-Prozess zu signalisieren, ist die Verwendung der <code>-k</code>-Befehlszeilenoptionen <code>stop</code>, <code>restart</code> und <code>graceful</code>, wie unten beschrieben. Dies sind Argumente des <a href="programs/httpd.html">httpd</a>-Programms, es wird jedoch empfohlen, sie unter Verwendung des Steuerskripts <a href="programs/apachectl.html">apachectl</a> zu senden, welches diese an <code>httpd</code> durchreicht.</p> <p>Nachdem Sie <code>httpd</code> signalisiert haben, k÷nnen Sie dessen Fortschritt beobachten, indem Sie eingeben:</p> <div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div> <p>Passen Sie diese Beispiele entsprechend Ihren <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>- und <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>-Einstellungen an.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="term" id="term">Beenden</a></h2> <dl><dt>Signal: TERM</dt> <dd><code>apachectl -k stop</code></dd> </dl> <p>Das Senden des <code>TERM</code>- oder <code>stop</code>-Signals an den Elternprozess veranlasst diesen, sofort zu versuchen, alle seine Kindprozesse zu beenden. Es kann einige Sekunden dauern, bis alle Kindprozesse komplett beendet sind. Danach beendet sich der Elternprozess selbst. Alle gerade bearbeiteten Anfragen werden abgebrochen. Es werden keine weiteren Anfragen mehr bedient.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="graceful" id="graceful">Unterbrechungsfreier Neustart</a></h2> <dl><dt>Signal: USR1</dt> <dd><code>apachectl -k graceful</code></dd> </dl> <p>Das <code>USR1</code>- oder <code>graceful</code>-Signal veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich nach Abschlu▀ ihrer momentanen bearbeiteten Anfrage zu beenden (oder sich sofort zu beenden, wenn sie gerade keine Anfrage bedienen). Der Elternprozess liest seine Konfigurationsdateien erneut ein und ÷ffnet seine Logdateien neu. Wenn ein Kindprozess stirbt, ersetzt der Elternprozess ihn durch ein Kind der neuen Konfigurations-<em>Generation</em>. Dieses beginnt sofort damit, neue Anfragen zu bedienen.</p> <div class="note">Auf bestimmten Plattformen, welche kein <code>USR1</code> fⁿr einen unterbrechungsfreien Neustart erlauben, kann ein alternatives Signal verwendet werden (wie z.B. <code>WINCH</code>). Der Befehl <code>apachectl graceful</code> sendet das jeweils richtige Signal fⁿr Ihre Platform.</div> <p>Der Code ist dafⁿr ausgelegt, stets die MPM-Direktiven zur Prozesssteuerung zu beachten, so dass die Anzahl der Prozesse und Threads, die zur Bedienung der Clients bereitstehen, wΣhrend des Neustarts auf die entsprechenden Werte gesetzt werden. Weiterhin wird <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> auf folgende Art und Weise interpretiert: Wenn nach einer Sekunde nicht mindestens <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> neue Kindprozesse erstellt wurden, dann werden, um den Durchsatz zu beschleunigen, entsprechend weitere erstellt. Auf diese Weise versucht der Code sowohl die Anzahl der Kinder entsprechend der Serverlast anzupassen als auch Ihre Wⁿnsche hinsichtlich des Parameters <code class="directive">StartServers</code> zu berⁿcksichtigen.</p> <p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen, dass die Serverstatistiken <strong>nicht</strong> auf Null zurⁿckgesetzt werden, wenn ein <code>USR1</code> gesendet wurde. Der Code wurde so geschrieben, dass sowohl die Zeit minimiert wird, in der der Server nicht in der Lage ist, neue Anfragen zu bedienen (diese werden vom Betriebssystem in eine Warteschlange gestellt, so dass sie auf keinen Fall verloren gehen) als auch Ihre Parameter zur Feinabstimmung berⁿcksichtigt werden. Um dies zu erreichen, muss die <em>Statustabelle</em> (Scoreboard), die dazu verwendet wird, alle Kinder ⁿber mehrere Generationen zu verfolgen, erhalten bleiben.</p> <p>Das Statusmodul benutzt au▀erdem ein <code>G</code>, um diejenigen Kinder zu kennzeichen, die noch immer Anfragen bedienen, welche gestartet wurden, bevor ein unterbrechungsfreier Neustart veranla▀t wurde.</p> <p>Derzeit gibt es keine M÷glichkeit fⁿr ein Log-Rotationsskript, das <code>USR1</code> verwendet, sicher festzustellen, dass alle Kinder, die in ein vor dem Neustart ge÷ffnetes Log schreiben, beendet sind. Wir schlagen vor, dass Sie nach dem Senden des Signals <code>USR1</code> eine angemessene Zeitspanne warten, bevor Sie das alte Log anfassen. Wenn beispielsweise die meisten Ihrer Zugriffe bei Benutzern mit niedriger Bandbreite weniger als 10 Minuten fⁿr eine vollstΣndige Antwort ben÷tigen, dann k÷nnten Sie 15 Minuten warten, bevor Sie auf das alte Log zugreifen.</p> <div class="note">Wenn Ihre Konfigurationsdatei Fehler enthΣlt, wΣhrend Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten, sondern sich mit einem Fehler beenden. Im Falle eines unterbrechungsfreien Neustarts lΣ▀t er die Kinder weiterlaufen, wenn er sich beendet. (Dies sind die Kinder, die sich "sanft beenden", indem sie ihre letzte Anfrage erledigen.) Das verursacht Probleme, wenn Sie versuchen, den Server neu zu starten -- er ist nicht in der Lage, sich an die Ports zu binden, an denen er lauschen soll. Bevor Sie einen Neustart durchfⁿhren, k÷nnen Sie die Syntax der Konfigurationsdateien mit dem Befehlszeilenargument <code>-t</code> ⁿberprⁿfen (siehe auch <a href="programs/httpd.html">httpd</a>). Das garantiert allerdings nicht, dass der Server korrekt starten wird. Um sowohl die Syntax als auch die Semantik der Konfigurationsdateien zu prⁿfen, k÷nnen Sie versuchen, <code>httpd</code> als nicht-root-Benutzer zu starten. Wenn dabei keine Fehler auftreten, wird er versuchen, seine Sockets und Logdateien zu ÷ffnen und fehlschlagen, da er nicht root ist (oder weil sich der gegenwΣrtig laufende <code>httpd</code> bereits diese Ports gebunden hat). Wenn er aus einem anderen Grund fehlschlΣgt, dann liegt wahrscheinlich ein Konfigurationsfehler vor. Der Fehler sollte behoben werden, bevor der unterbrechungsfreie Neustart angewiesen wird.</div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="hup" id="hup">Neustarten</a></h2> <dl><dt>Signal: HUP</dt> <dd><code>apachectl -k restart</code></dd> </dl> <p>Das Senden des Signals <code>HUP</code> oder <code>restart</code> veranla▀t den Elternprozess, wie bei <code>TERM</code> alle seine Kinder zu beenden. Der Elternprozess beendet sich jedoch nicht. Er liest seine Konfigurationsdateien neu ein und ÷ffnet alle Logdateien erneut. Dann erzeugt er einen neuen Satz Kindprozesse und setzt die Bedienung von Zugriffen fort.</p> <p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen, dass die Serverstatistiken auf Null gesetzt werden, wenn ein <code>HUP</code> gesendet wurde.</p> <div class="note">Wenn Ihre Konfigurationsdatei einen Fehler enthΣlt, wΣhrend Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten, sondern sich mit einem Fehler beenden. Lesen Sie oben, wie Sie das vermeiden k÷nnen.</div> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="race" id="race">Anhang: Signale und Wettkampfsituationen</a></h2> <p>Vor der Version 1.2b9 des Apache existierten verschiedene <em>Wettkampfsituationen</em> (race conditions), die den Neustart und die Signale beeinflu▀t haben. (Eine einfache Beschreibung einer Wettkampfsituation lautet: es ist ein zeitabhΣngiges Problem; wenn etwas zum falschen Zeitpunkt erfolgt, wird es sich nicht wie erwartet verhalten.) Bei Architekturen mit dem "richtigen" Funktionsumfang haben wir so viele eliminiert wie wir nur konnten. Dennoch sollte beachtet werden, dass noch immer Wettkampfsituationen auf bestimmten Architekturen existieren.</p> <p>Bei Architekturen, die ein <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> auf Platte verwenden, besteht die Gefahr, dass die Statustabelle beschΣdigt wird. Das kann zu "bind: Address already in use" ("bind: Adresse wird bereits verwendet", nach einem <code>HUP</code>) oder "long lost child came home!" ("Der verlorene Sohn ist heimgekehrt", nach einem <code>USR1</code>) fⁿhren. Ersteres ist ein schwerer Fehler, wΣrend letzteres lediglich bewirkt, dass der Server einen Eintrag in der Statustabelle verliert. So kann es ratsam sein, unterbrechungsfreie Neustarts zusammen mit einem gelegentlichen harten Neustart zu verwenden. Diese Probleme lassen sich nur sehr schwer umgehen, aber glⁿcklicherweise ben÷tigen die meisten Architekturen keine Statustabelle in Form einer Datei. Bitte lesen Sie fⁿr Architekturen, die sie ben÷tigen, die Dokumentation zu <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code>.</p> <p>Alle Architekturen haben in jedem Kindprozess eine kleine Wettkampfsituation, welche die zweite und nachfolgende Anfragen einer persistenten HTTP-Verbindung (KeepAlive) umfa▀t. Der Prozess kann nach dem Lesen der Anfragezeile aber vor dem Lesen der Anfrage-Header enden. Es existiert eine Korrektur, die fⁿr 1.2 zu spΣt kam. Theoretisch sollte das kein Problem darstellen, da der KeepAlive-Client derartige Ereignisse aufgrund von Netzwerk-Latenzzeiten und Auszeiten des Servers erwarten sollte. In der Praxis scheint keiner von beiden beeinflu▀t zu werden -- in einem Testfall wurde der Server zwanzig mal pro Sekunde neu gestartet, wΣhrend Clients das Angebot abgegrast haben, ohne kaputte Bilder oder leere Dokumente zu erhalten.</p> </div></div> <div class="bottomlang"> <p><span>Verfⁿgbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> | <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Espa±ol"> es </a> | <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="./ru/stopping.html" hreflang="ru" rel="alternate" title="Russian"> ru </a></p> </div><div id="footer"> <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div> </body></html> 
